home *** CD-ROM | disk | FTP | other *** search
/ Power DOS 1996 July / Power DOS - July 1996.iso / sound / c_labs / vs / cinepa.exe / README.TXT < prev    next >
Text File  |  1993-06-15  |  15KB  |  397 lines

  1.                Video Spigot for Windows
  2.                  Product Version 1.0
  3.                Release Version 1.3.0.1
  4.  
  5. ----- Changes for release 1.3 -----------------------------------------------
  6.  
  7. VideoSpigot for Windows
  8.  
  9. 1.  When installing VideoSpigot for Windows, the target system's bus
  10.     performance is tested.  If capture performance is too low,
  11.     full-field (640x480) capture is disabled and a flag is set in the
  12.     [SPIGOT.DRV] section of SYSTEM.INI.  The flag can be changed to
  13.     override the disable, enabling full-field capture even if the
  14.     automatic bus performance measurement implies that full-field
  15.     capture quality would be compromised.  The flag values:
  16.       FullFieldCapture=0    disable full-field capture
  17.       FullFieldCapture=1    enable full-field capture
  18.       FullFieldCapture=2    re-measure bus performance at next startup
  19.  
  20. 2.  Addresses in the range F00000 through F1FFFF are not valid for
  21.     placing VideoSpigot for Windows.
  22.  
  23.  
  24. Cinepak Codec
  25.  
  26. 1.  The compressor will now insert a key frame when it detects a scene
  27.     change in the source material.
  28.  
  29. 2.  Bright fields would occasionally have dark patches in them when
  30.     the compressed clip was played back.  The problem has been fixed.
  31.  
  32.  
  33. ----- Instructions for Installation of the VideoSpigot Capture Driver -------
  34.  
  35.  1. Make sure that you have installed your distribution of the released
  36.     version of Microsoft's Video for Windows.
  37.  
  38.  2. When running Windows, do the following:
  39.  
  40.      a. Open up the Control Panel application and invoke the Drivers
  41.         applet.
  42.  
  43.      b. From the Drivers applet's main window select the Add... pushbutton.
  44.  
  45.      c. In the Add dialog box which then appears choose the selection
  46.         "Unlisted or Updated Driver" from the List of Drivers listbox.
  47.  
  48.      d. In the Install Driver dialog box which then appears enter either
  49.         A:\ or B:\ in the edit field, depending on which drive you have
  50.     inserted the VideoSpigot diskette. Press OK. 
  51.  
  52.      e. In the Add Unlisted or Updated Driver dialog box which should then
  53.         appear, you should see the following entries:
  54.  
  55.         SuperMatch Cinepak Codec
  56.         SuperMatch VideoSpigot Capture Driver
  57.         SuperMatch VideoSpigot Codec
  58.         SuperMatch YUV 4:2:2 Video Codec
  59.  
  60.         Select 'SuperMatch VideoSpigot Capture Driver' and press OK.
  61.  
  62.      f. The capture driver will be copied into your Window's system subdirectory
  63.         and another dialog box entitled, VideoSpigot Device Setup, will
  64.     appear.
  65.  
  66.      g. VideoSpigot uses I/O addresses 0AD6h through 0AD9h.  These
  67.         addresses are active all the time and are not reassignable.
  68.  
  69.     While capture is in process, VideoSpigot needs to have access to
  70.     an interrupt and an 8KB memory buffer in your system.
  71.  
  72.     The Scan...  pushbutton to the right of the Interrupt Address
  73.     combo box will start an automatic IRQ scan that will attempt to
  74.     locate an available IRQ address from among the VideoSpigot
  75.     choices of 10, 11, or 15.  The scan is not foolproof; you must
  76.     select one of these that has no conflict with other hardware.
  77.  
  78.     The Scan...  pushbutton to the right of the Base Memory Address
  79.     combo box will start an automatic memory scan that will attempt
  80.     to locate available 8KB memory blocks at which VideoSpigot may
  81.     be installed.  VideoSpigot requires an unused 8KB block in the
  82.     bottom megabyte (addresses 000A0000 through 000FFFFF) or top
  83.     megabyte (addresses 00F00000 through 00FFFFFF) of your machine's
  84.     ISA bus physical address space.
  85.  
  86.     NOTE:  VideoSpigot is a 16 bit device.  You must ensure that no
  87.            8 bit memory devices reside in the 128KB block in which
  88.            you have assigned VideoSpigot.
  89.  
  90.     The mechanism used by the VideoSpigot capture driver to access
  91.     the physical address space allocated to the buffer does not
  92.     require that you exclude the address of the buffer in any EMM386
  93.     (or other memory manager) lines in your CONFIG.SYS.
  94.  
  95.     Once you have made all your selections, press OK and installation
  96.     of the capture driver for the VideoSpigot card is complete.
  97.  
  98. -------- Instructions for Installation of VideoSpigot Codecs----------
  99.  
  100. To fully take advantage of VideoSpigot's capability to capture video
  101. data to raw YUV, Spigot compressed, and/or do post-capture compression
  102. with the Cinepak codec, you must also install the supplied compressor
  103. drivers.  To do this:
  104.  
  105.  1. When running Windows, do the following:
  106.  
  107.      a.  Open up the Control Panel application and invoke the Drivers
  108.      applet.
  109.  
  110.      b.  From the Drivers applet's main window select the Add...
  111.      pushbutton.
  112.  
  113.      c.  In the Add dialog box which then appears choose the selection
  114.      "Unlisted or Updated Driver" from the List of Drivers listbox.
  115.  
  116.      d.  In the Install Driver dialog box which then appears enter
  117.      either A:\ or B:\ in the edit field, depending on which drive
  118.      you have inserted the VideoSpigot diskette.  Press OK.
  119.  
  120.      e.  In the Add Unlisted or Updated Driver dialog box which should
  121.      then appear, you should see the following entries:
  122.  
  123.         SuperMatch Cinepak Codec
  124.         SuperMatch VideoSpigot Capture Driver
  125.         SuperMatch VideoSpigot Codec
  126.         SuperMatch YUV 4:2:2 Video Codec
  127.  
  128.      Select 'SuperMatch VideoSpigot Codec' and press OK.
  129.  
  130.      f.  The VideoSpigot Video Codec driver will be copied into your
  131.      Window's system subdirectory and its installation should then
  132.      be complete.
  133.  
  134.      g.  Next, install the SuperMatch YUV 4:2:2 Video Codec by repeating
  135.      steps b  through e.
  136.  
  137.      g.  Next, install the Cinepak Codec by repeating steps b through e.
  138.  
  139.  
  140. NOTES
  141. =====
  142.  
  143. There are several factors that you should take into consideration so that
  144. you may achieve the most optimal capture rates possible for your system:
  145.  
  146.     1. Disk fragmentation - if your hard disk is highly fragmented then
  147.        it will take more time to access data within files and therefore
  148.        reading and writing AVI files will take up more of your system's
  149.        bandwidth. Because less time is available to the capture process
  150.        when a disk is fragmented, captures rates will suffer. Make sure
  151.        that you periodically defragment your disk (several utilities for
  152.        doing this are available commercially -- PC Tools, WinMaster,
  153.        etc...). Make especially sure that your disk is defragmented before
  154.        you create the main capture file that VIDCAP will use during
  155.        capture.
  156.  
  157.     2. Disk Transfer Performance -- A hard disk which is slow at
  158.        transferring data will impair capture rates since data will not
  159.        be able to be transferred to disk fast enough to keep up with
  160.        the rate at which data is being captured. On these slower hard
  161.        disks you may find that capture rates actually go up when the
  162.        data being captured is written to a capture file located on a
  163.        compressed disk volume (logical disk drives created by utilities
  164.        such as Stacker that maintain the data on the disk as a compressed
  165.        data). This is due to the reduced amount of data needing to be
  166.        written to the disk during the capture process as a result of
  167.        data compression.
  168.  
  169.     3. System Processor - More powerful CPU chips will allow a greater
  170.        amount of processing in a given amount of time. Much of the
  171.        capture process depends on software execution on the system
  172.        processor, so it follows that more powerful CPU's will yield
  173.        higher capture rates. This is in fact the case, as you can expect
  174.        to get higher capture rates on '486 CPU's versus '386 CPU's.
  175.     
  176.     4. System Clock Speed - For the same reasons stated in 3. above
  177.        higher capture rates will be achieved on systems that have a
  178.        higher system clock speed. Thus, 50 MHz systems will yield
  179.        higher capture rates than 33MHz systems which will yield higher
  180.        capture rates than 25MHz systems.
  181.  
  182.     5. System Bus Speed - Most AT compatibles have adapter card buses
  183.        which are set at 8MHz. Some compatibles allow the bus speed
  184.        to be set higher with the tradeoff that some adapter cards may
  185.        not correctly work at the higher bus speed. If all the adapter
  186.        cards in your system function correctly at a higher bus speed then
  187.        you can realize higher capture rates at the higher bus speed.
  188.  
  189.     6. Video Capture Format - During video capture, the VideoSpigot
  190.        capture driver allows a user to select from among 5 different
  191.        capture formats:
  192.  
  193.            8 bit palettized         (256 colors)
  194.            8 bit dithered             (256 colors)
  195.         16 bit RGB555            (32K colors)
  196.         24 bit RGB            (16M colors)
  197.         Spigot Compression        (64K colors)
  198.         YUV 4:2:2            (16M colors)
  199.  
  200.        Selection of the YUV 4:2:2 format will normally result in the
  201.        highest capture rates since the least amount of data manipulation
  202.        is necessary in this capture format (the native format retrieved
  203.        from VideoSpigot). However, YUV 4:2:2 format requires twice the
  204.        amount of file space as 8 bit palettized or Spigot Compression,
  205.        and on slower hard disks this could result in slower capture
  206.        rates. You will need to experiment to determine the optimum
  207.        formats for capture.
  208.  
  209.     7. Video Capture Method - VIDCAP allows a user to select parameters
  210.        associated with capture in its Capture Video Sequence dialog
  211.        box. Make sure that you select Capture to Memory. This selection
  212.        will reduce considerably the degradation that a hard disk will
  213.        effect on the capture rate.
  214.  
  215.  
  216. Explanation of SYSTEM.INI Options for VideoSpigot
  217. =================================================
  218.  
  219. The VideoSpigot capture driver retains information about current capture
  220. parameters and hardware setups in the Window's SYSTEM.INI file. All
  221. options will be recorded in the [spigot.drv] section of the SYSTEM.INI.
  222. Current keywords and their possible values are:
  223.  
  224.     Keyword        Legal Values    Description
  225.     -------        ------------    -----------
  226.  
  227.     CaptureField    0        VideoSpigot will capture only the
  228.                         even fields of an interlaced input
  229.                     signal. For non-interlaced video
  230.                     signals this flag has no effect.
  231.  
  232.             16 (default)    VideoSpigot will capture only the
  233.                     odd fields of an interlaced input
  234.                     signal. For non-interlaced video
  235.                     signals this flag has no effect.
  236.  
  237.  
  238.     FullFieldCapture    0        Disable full-field capture
  239.  
  240.                 1        Enable full-field capture
  241.  
  242.             2        Force bus performance
  243.                     measurement cycle on next
  244.                     startup of VideoSpigot for
  245.                     Windows.  Full-field capture
  246.                     will be enabled or disabled
  247.                     depending on results of bus
  248.                     performance.
  249.  
  250.  
  251.     Hue            0 - 255        Shifts the colors towards green on
  252.                         the low end and towards blue on the
  253.                     high end of the range. The default
  254.                     value is 128.
  255.  
  256.  
  257.     InputChannel    0        Always assume video data is being
  258.                     input on the composite connector of
  259.                     the card.
  260.  
  261.             1        Always assume video data is being
  262.                     input on the SVHS connector of the
  263.                     card.
  264.     
  265.                 2 (default)    Connector on which active video data
  266.                         is input will be determined via an
  267.                     autodetect algorithm in which the
  268.                     SVHS connector is given priority.
  269.  
  270.  
  271.     Interrupt        10,11,15    Possible IRQ values for the vertical
  272.                         sync interrupt of the VideoSpigot
  273.                     card.
  274.  
  275.  
  276.     LineBreak.1.8    0 - 100        For 1/8 field capture (Width = 80 for
  277.                         NTSC, = 96 for PAL,SECAM): % of
  278.                     scanlines remaining to be read
  279.                         from current frame being captured
  280.                     before capture of next frame is
  281.                     initiated. Default is 20%.
  282.  
  283.     LineBreak.1.4    0 - 100        For 1/4 field capture (Width = 160 for
  284.                         NTSC, = 192 for PAL,SECAM): % of
  285.                     scanlines remaining to be read
  286.                         from current frame being captured
  287.                     before capture of next frame is
  288.                     initiated. Default is 20%.
  289.  
  290.     LineBreak.3.8    0 - 100        For 3/8 field capture (Width = 240 for
  291.                         NTSC, = 288 for PAL,SECAM): % of
  292.                     scanlines remaining to be read
  293.                         from current frame being captured
  294.                     before capture of next frame is
  295.                     initiated. Default is 20%.
  296.  
  297.     LineBreak.1.2    0 - 100        For 1/2 field capture (Width = 320 for
  298.                         NTSC, = 388 for PAL,SECAM): % of
  299.                     scanlines remaining to be read
  300.                         from current frame being captured
  301.                     before capture of next frame is
  302.                     initiated. Default is 20%.
  303.  
  304.     LineBreak.Full    0 - 100        For full field capture (Width = 640 for
  305.                         NTSC): % of scanlines remaining to be
  306.                     read from current frame being captured
  307.                     before capture of next frame is
  308.                     initiated. Default is 20%.
  309.  
  310.  
  311.     MemoryBase        0A0000-0FE000    On 8KB boundaries the valid address
  312.                 F02000-FFE000    bases to locate VideoSpigot at.
  313.  
  314.  
  315.     ntscTOF        4-15        The # of lines skipped at the top
  316.                         of the current field being captured
  317.                     when running in NTSC mode. This allows
  318.                     the user to prevent lines of inactive
  319.                     video data from being captured (an
  320.                     example of such non-video data would
  321.                     be closed captioned text prepended to
  322.                     the video data in many recordings).
  323.                     The default # of lines to skip is 11.
  324.  
  325.  
  326.     palTOF        4-15        The # of lines skipped at the top
  327.                         of the current field being captured
  328.                     when running in PAL or SECAM mode.
  329.                     This allows the user to prevent lines
  330.                     of inactive video data from being
  331.                     captured (an example of such non-video
  332.                     data would be closed captioned text
  333.                     prepended to the video data in many
  334.                     recordings). The default # of lines
  335.                     to skip is 15.
  336.  
  337.  
  338.     SpigotTime        any        Result of bus performance
  339.                     measurement.  See
  340.                     FullFieldCapture.  The automatic
  341.                     measurement allows full-field
  342.                     capture if SpigotTime is <= 1250.
  343.  
  344.  
  345.     VCR            0        Turn off hardware feature that enables
  346.                         extra gain control for video signals
  347.                     sourced from a VCR.
  348.  
  349.             1 (default)    Turn on hardware feature that enables
  350.                     extra gain control for video signals
  351.                     sourced from a VCR. If this feature is
  352.                     turned off, VCR signals may appear
  353.                     to roll.
  354.  
  355.  
  356.     VideoFormat        0        Video data will be captured in the
  357.                         8 bit Palettized format.
  358.  
  359.             1        Video data will be captured in the
  360.                     16 bit RGB555 format.
  361.  
  362.             2        (reserved, not used)
  363.  
  364.             3        Video data will be captured in the
  365.                     24 bit RGB format.
  366.  
  367.             4        Video data will be captured in the
  368.                     Spigot Compressed format.
  369.  
  370.             5        Video data will be captured in the
  371.                     YUV 4:2:2 format.
  372.  
  373.             6 (default)    Video data will be captured in the
  374.                     8 bit Dithered format.
  375.  
  376.  
  377.     VideoStandard    1        Video data is encoded using the PAL
  378.                         video transmission standard.
  379.  
  380.             2 (default)    Video data is encoded using the NTSC 
  381.                     video transmission standard.
  382.  
  383.             3        Video data is encoded using the SECAM
  384.                     video transmission standard.
  385.  
  386.  
  387.     Width        80        Widths that VideoSpigot can capture
  388.                 160 (default)    when running in NTSC mode.
  389.             240
  390.             320
  391.             640
  392.  
  393.             96        Widths that VideoSpigot can capture
  394.             192 (default)    when running in PAL,SECAM mode.
  395.             288
  396.             384
  397.